home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
windows4
/
profile.zip
/
README
< prev
next >
Wrap
Text File
|
1991-05-08
|
4KB
|
111 lines
Microsoft Usage and Description README File
Windows 16-bit API Profiler
October 30, 1990
1. Hardware/Software Requirements
o 80386 based PC
o Windows 3.x
2. Profiling DLLS
o zernel.* kernel APIs' profiling DLL.
o zser.* user APIs' profiling DLL.
o zdi.* gdi APIs' profiling DLL.
3. Other Files
o apfcnvrt.exe Converts modules from the application to be profiled
to use the profiling DLL(s).
(OS/2 bound type exe)
o apfdump.exe Dumps profiling data while application is running.
(Windows type exe)
o timerwin.dll Timer DLL used for profiling under Windows.
o vtd.386 A Virtual Timer Device to be used under WIN 3.0
(Windows 3.1 and above will have this virtual device
built in)
4. How to Run the Profiler
o Copy the profiling dlls to someplace on your lib path.
o Copy the timer DLL (timerWIN.dll) to someplace on your lib path.
If profiling under Windows 3.0, VTD.386 need to be installed
in SYSTEM.INI file. Replace "device=*vtd" line with
"device=%fullpath%\vtd386". Windows 3.1 and above will have this
VTD built in.
o Use APFCNVRT to convert the modules from the application you
wish to profile to use profiling DLL(s).
Examples:
apfcnvrt ? -- Displays the usage
apfcnvrt win excel.exe -- Profiles all windows calls
under excel
apfcnvrt zser winword.exe *.dll -- Profiles only user calls
made by winword and its
supporting dll's.
o Run the application you wish to profile.
o You can run APFDUMP (windows app) to dump the profiling data while
the application is running. As the default APFDUMP will dump the
profiling data to *.DMP files. Dump files extenstion may be
changed from the dialog box. If both <DUMP> and <CLEAR> options
are selected data will be cleared after data is dumped.
Do *NOT* use 'DAT' as dump file extension in apfdump since once the
application is ended, the profiling info is dumped to *.DAT files.
o Use APFCNVRT to restore use of original mudules in the
profiled application. ("unhooking" the application from profiler)
Examples:
apfcnvrt ? -- Displays the usage
apfcnvrt undo excel.exe -- Restore original excel
imports
apfcnvrt user winword.exe *.dll -- "unhooks" user profiling
from winword and its
supporting dll's.
5. Profiling Data
The following information is captured as profiling data:
o API name -- API name
o Num Calls -- Number of times the API is called
o Total Time -- Total time for all the calls to the API
o Time/call -- Average time for API call
o First Time -- Time of first call to the API
o Max Time -- Maximum call time for the API (after the first call)
o Min Time -- Minimum call time for the API (after the first call)
o Not Timed -- Number of calls not timed due to timing overflows
All the fields in the dump files are tab separated so they
can be loaded under Excel.
6. Comments
o The API profiling DLLs only work in enhanced mode.
*** END OF README ***